home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mahjongg.zip / MAHJONGG.DOC < prev    next >
Text File  |  1991-07-04  |  16KB  |  528 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ┌────────────────────────────────────────────┐
  15.                  │                                            │
  16.                  │               Mahjongg Pyramid             │
  17.                  │           =======================          │
  18.                  │                                            │
  19.                  │         A Live Game for Many BBS's         │
  20.                  │                                            │
  21.                  │   Game Release Version 1.0 - 02/14/91      │
  22.                  │                                            │
  23.                  │             (C)opyright 1991               │
  24.                  │                                            │
  25.                  │                   By                       │
  26.                  │                                            │
  27.                  │            SECRET SERVICE BBS              │
  28.                  │                                            │
  29.                  │              Mike Wilson                   │
  30.                  │             P.O. Box 9521                  │
  31.                  │            Huntington, WV                  │
  32.                  │                  25704                     │
  33.                  │                                            │
  34.                  │            BBS (304) 429-6838              │
  35.                  │            1200/2400/9600 24 hrs.          │
  36.                  │                                            │
  37.                  │                                            │
  38.                  │                                            │
  39.                  │                                            │
  40.                  └────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.               Mahjongg Pyramid  (C)opyright 1991 - Page 1
  67.  
  68.  
  69.  
  70.  
  71.                                   Warranty
  72.  
  73.  
  74. This is product is provided "as is" without warranty of any kind.  The
  75. entire risk as to the results and performance of the program is assumed by
  76. you. Futher more, I the author do not warrant, guarantee, or make any
  77. representations regarding the use of, or the results of the use of the program,
  78. and you rely on the program and results solely at your own risk.  I the author
  79. cannot accept responsibility for system damage, loss of profit, or any other
  80. special, incidental, or consequential damages resulting from the use or
  81. inability to use this product.
  82.  
  83.  
  84.                                  Copyright
  85.  
  86.  
  87. The Multi-Board Mahjongg Pyramid live game is distributed as SHAREWARE.
  88. Under this concept you may use the SHAREWARE (unregistered) version for a
  89. reasonable period of time, which I consider to be three weeks, after which you
  90. must either register your copy or discontinue usage.
  91.  
  92.  
  93.                                Registration
  94.  
  95. With registration you will recieve the latest registered copy of Mahjongg
  96. Pyramid with the ability to download any futher updates from Secret Service
  97. at no extra  cost. You will also recieve any support the author can give
  98. in reference to bugs or other problems that may arise in using the game.
  99.  
  100. I feel that sysop's have enough expense without charging a high cost for a game
  101. for their users. I have set the cost of registration at $20.00 which I feel
  102. if people will follow the shareware concept will be enough to cover shipping
  103. and handling and encourage me to write more doors.
  104. See register.txt for ordering instructions.
  105.  
  106.  
  107.                                Distribution
  108.  
  109. You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
  110. version of Multi-board Mahjongg Pyramid Live Game provided that all files
  111. contained in the original Mahjongg Pyramid archive are distributed in their
  112. original unmodified state.
  113.  
  114.  
  115.  
  116.                                Introduction
  117.                                      &
  118.                                 How To Play
  119.  
  120. Mahjongg Pyramid is a Pyramid version of the popular tile game. The tiles
  121. are dealt into a pyramid and a user must match open tiles to have them
  122. removed from the play area. The object of the game is to remove all tiles
  123. from the play area. Bonus points are given as each row is removed.
  124. There are 48 tiles in all (Eight types with six of each type). Twenty
  125. are dealt onto the pyramid and the rest are placed in a stack. Players
  126. continue to match and remove tiles until they exhaust all plays.
  127. Scores are kept on a monthly basis.
  128.  
  129.  
  130.  
  131.  
  132.               Mahjongg Pyramid  (C)opyright 1991   Page - 2
  133.  
  134.  
  135.  
  136.                           Options and Information
  137.  
  138. This door game will also create color and mono top 10 bulletins and write them
  139. in directories of your choice written in the .CFG file. The top player of the
  140. previous month is displayed within the bulletins as well as the all time
  141. high scorer.
  142.  
  143.  
  144.  
  145.                       Installation and Setup
  146.  
  147. Setup of the game is a simple procedure. Create a directory for Mahjongg
  148. Pyramid and unzip the files in Mahjongg.zip into the directory.
  149. Run Setup.exe and answer the questions that are asked. (If your unsure
  150. of an answer refer to areas described below in the docs).
  151. Once you answer the questions in the setup program set up a batch
  152. file to call it from within your bbs as described in the batch
  153. file section of these docs.
  154.  
  155. I will describe each file that exists or is created by Setup.exe
  156.  
  157.  
  158. Mahjongg.CFG contains:
  159.  
  160. The Secret Service BBS           <-- Name of BBS
  161. Mike                             <-- Sysop's first name
  162. Wilson                           <-- Sysop's last name
  163. C:\Path\BBSinfo.???              <-- Path and filename for Board Info File
  164. C:\Path\Bulletin.clr   <-- Path & Filename to create COLOR bulletin
  165. C:\Path\Bulletin.asc   <-- Path & Filename to create MONO bulletin
  166. NO                               <-- NO or locked COM PORT Baud Rate
  167.  
  168. The line above that references the path and name of the board info file
  169. should be the path and file to the file that your particular BBS creates
  170. when it drops out to run a game. This would be:
  171. WILDCAT prior to V3.0  ---> Callinfo.bbs    Spitfire ---> SFDoors.dat
  172. GAP or Wildcat 3.0+ ------> Door.sys        PCBoard -> PCBoard.sys
  173. QuickBBS ---> DorinfoX.Def (The X is 1 or 2 depending on node)
  174.  
  175. The path to color and mono bulletins can be any valid path and any
  176. valid name that you want the top ten scores bulletins written to.
  177.  
  178.  
  179. NOTE FOR MULTI NODES!
  180. You may now have several .cfg files to allow use on multinode systems.
  181. Use the above .cfg format but name each .cfg file differently. Just use
  182. an ASCII format word processor or Copy Con or Edlin. You may call
  183. them what you want as long as you correctly call them from the
  184. batch file command line.
  185.  
  186. Example:    Node1:     game game.cfg
  187.  
  188.             Node2:     game game1.cfg
  189.  
  190.  
  191. ** NOTE: If you run Multi-nodes and use a Non-Standard Port Address
  192.          or IRQ value then read PORT.DOC to set these up!
  193.  
  194.  
  195.  
  196.  
  197.  
  198.               Mahjongg Pyramid  (C)opyright 1991  Page - 3
  199.  
  200.  
  201.  
  202. Mahjongg.DAT contains:
  203.  
  204.  
  205. This file contains the following user data:
  206.  
  207. "The Champion","01-20-1991","100"
  208.  
  209. Data has to be kept in this format, but you can delete all lines except for
  210. line number 1 which is the Last Months Champ line. You can alter line 1 but
  211. not remove it. You need to alter line 1's Date form 02-14-1991 to the month
  212. that your setting up this door. For example if it is December just simply
  213. change the Date to 12-01-1991. It doesn't matter if it's the 1st or the 10th,
  214. only the Month (12) will make any difference.
  215.  
  216.  
  217. Mahjongg.TXT contains:
  218.  
  219. This is the instruction file for Mahjongg Pyramid. When a user selects the
  220. See Instructions option during the game, this file is read for
  221. instructions. This file MUST BE PRESENT and Not altered in any way for
  222. Mahjongg Pyramid to run properly
  223.  
  224.  
  225.  
  226. BOARD.TXT
  227. ---------
  228. Don't worry about this file. It is created when you run setup.exe
  229. This file tells the game which BBS Software you are running and
  230. tells it to read the correct board file. THERE SHOULD NOT BE A
  231. BOARD.TXT FILE IN THE GAME DIRECTORY IF YOUR RUNNING WILDCAT
  232. PRIOR TO VERSION 3.0!
  233. The game looks for this file and defaults to Wildcat if it isn't
  234. found.
  235. For other boards it will contain one line with one of the following:
  236. QuickBBS --------> QBBS         GAP or Wildcat 3.0+ ------> GAP
  237. PCBoard ---------> PCB          Spitfire -----------------> SPITFIRE
  238.  
  239.  
  240.  
  241. PORT.DOC
  242. ---------
  243. Read this only if you run coms 3 or 4 as Non-standard port addresses
  244. or non-standard IRQ's.
  245.  
  246.  
  247.                           List of Files In Archive
  248.  
  249. The following files are either found in your Mahjongg.ZIP or will be
  250. created during the runtime execution of the game.
  251.  
  252.  
  253. Mahjongg.EXE    <--- Executable Program.
  254.  
  255. Setup.exe    <--- Setup program for Mahjongg Pyramid
  256.  
  257. Mahjongg.DAT    <--- Store User's Name, Last Play Date & Score.
  258.  
  259. Mahjongg.TXT    <--- Instructions Used By Program.
  260.  
  261. BULLET##.SCR *<--- COLOR Bulletin
  262.  
  263.  
  264.               Mahjongg Pyramid  (C)opyright 1991  Page - 4
  265.  
  266. BULLET##.BBS *<--- MONO Bulletin
  267.  
  268. Mahjongg.DOC    <--- This File.
  269.  
  270. Champion.txt <--- The file that stores the all time champion score
  271.  
  272. Register.txt <--- Registration Information
  273.  
  274. Port.doc <------- Information on setting up Non-standard Ports & IRQ's
  275.  
  276. * DENOTES that file is created during RUN-TIME.
  277.  
  278.                                   Batch Files
  279.                                =================
  280.  
  281. Be sure that you have edited or created the Mahjongg.CFG file with the correct
  282. information as described earlier in these docs. The individual setups do not
  283. repeat this necessary process.
  284.  
  285. Wildcat! 1.13 & 2.0+ Setup:
  286. ---------------------------
  287. First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:
  288.  
  289.    ECHO OFF
  290.    CD \WILDCAT\DOORS\Mahjongg
  291.    Mahjongg Mahjongg.CFG
  292.    CD \WILDCAT
  293.    CAT.BAT
  294.  
  295. place this batch file in your Node# directory if running Multi-Nodes or in
  296. your Wildcat (default) directory if single node.
  297.  
  298. Second, Create a sub-directory for the door program such as in the following
  299. example:
  300.  
  301. C:\WILDCAT\DOORS\Mahjongg
  302.  
  303. Third, put the Mahjongg Pyramid game files in the \WILDCAT\DOORS\Mahjongg
  304. directory.
  305.  
  306. Forth, add this game to your live program menu for user selection and your
  307. ready to run the door.
  308.  
  309. If this is a little unclear then please read your systems documentation for
  310. more detailed instructions.
  311.  
  312. If you use a door monitoring program then read their documentation for
  313. their specific setup.
  314.  
  315.  
  316. Gap Setup:
  317. ----------
  318. First, add the number and name of the door to your menu. This will allow the
  319. user to select the door by number.
  320.  
  321. Second, edit or create the file called DOORS.DAT which is normally in the GEN
  322. directory. Following is an example line to add:
  323.  
  324.    MP 10
  325.  
  326. where 'MP' stands for the name of the batch file (shown below) to invoke the
  327. the door and '10' is the required security level.
  328.  
  329.  
  330.               Mahjongg Pyramid  (C)opyright 1991  Page - 5
  331.  
  332. Third, create a sub-directory for Mahjongg Pyramid to be placed in. And example
  333. would be:
  334.  
  335. C:\GAP\Mahjongg
  336.  
  337. place all the files in the Mahjongg.ZIP archive inside this directory.
  338.  
  339. Forth, create a batch file called Mahjongg which should be placed in the
  340. default directory. Following is example contents of this file:
  341.  
  342.    ECHO OFF
  343.    CD\GAP\Mahjongg
  344.    Mahjongg Mahjongg.CFG
  345.    CD\GAP
  346.    GAP
  347.  
  348. the last line in the Mahjongg file should invoke the batch file which loads
  349. the GAP BBS system.
  350.  
  351. If this is a little unclear then please read your systems documentation for
  352. more detailed instructions.
  353.  
  354. If you use a door monitoring program then read their documentation for
  355. their specific setup.
  356.  
  357.  
  358.  
  359. Spitfire Setup:
  360. ---------------
  361. First edit your SFDOOR.MNU and add the following line. If you are not running
  362. and doors at this time you will need to create this file.
  363.  
  364.    MahjonggPyramid, 10
  365.  
  366.    Where Mahjongg Pyramid is the name of the door to appear on your menu and the
  367.    10
  368.    is the lowest security level that will be allowed to enter the door. Don't
  369.    forget the comma (,) after the name.
  370.  
  371. Second create a sub-directory to place the door game in. In this example we
  372. will use 'C:\SF\DOOR_A' for the game directory.
  373.  
  374.  
  375. Third move all the files in the Mahjongg.ZIP archive into this directory.
  376.  
  377. Forth edit your SF.BAT file adding the following lines.
  378.  
  379. :DOOR_A
  380.    CD\SF\DOORS_A
  381.    Mahjongg Mahjongg.CFG
  382.    CD\SF
  383.    GOTO LOOP
  384.  
  385. Fifth, rerun Sf.BAT and your ready to begin play.
  386.  
  387. If this is a little unclear then please read your systems documentation for
  388. more detailed instructions.
  389.  
  390. If you use a door monitoring program then read their documentation for
  391. their specific setup.
  392.  
  393.  
  394.  
  395.  
  396.               Mahjongg Pyramid  (C)opyright 1991  Page - 6
  397.  
  398. PCBoard 14.0+ Setup:
  399. --------------------
  400. First, edit your DOORS and DOORSG file so that it shows Mahjongg Pyramid with
  401. the
  402. door
  403. number relating to it's position in DOORS.DAT.
  404.  
  405. Second, edit the DOORS.DAT file so that it includes Mahjongg.
  406.  
  407. Third, create a sub-directory for Mahjongg Pyramid to be placed in. And example
  408. would be:
  409.  
  410. C:\PCB\Mahjongg
  411.  
  412. place all the files in the Mahjongg.ZIP archive inside this directory.
  413.  
  414. Forth, create a batch file called Mahjongg which should be placed in the
  415. default directory. Following is example contents of this file:
  416.  
  417.    ECHO OFF
  418.    CD\PCB\Mahjongg
  419.    Mahjongg Mahjongg.CFG
  420.    CD\PCB
  421.    BOARD
  422.  
  423. the last line in the Mahjongg file should invoke the batch file which loads
  424. the PCboard BBS system.
  425.  
  426. If this is a little unclear then please read your systems documentation for
  427. more detailed instructions.
  428.  
  429. If you use a door monitoring program then read their documentation for
  430. their specific setup.
  431.  
  432.  
  433. QuickBBS Setup:
  434. ---------------
  435. First, add the game to your games menu and select the correct type for doors.
  436.  
  437. Second, create a sub-directory for the game and move all the files from the
  438. zip file to this directory.
  439.  
  440. Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
  441. Since QuickBBS only supports one node at this time then this file should be
  442. 'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
  443. of the configuration file.
  444.  
  445.    Note: It was told to me that the upcoming 3.0 version of QuickBBS will
  446.          support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
  447.          to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
  448.          where you can specify this new name as well as any others.
  449.  
  450. Forth, create a batch file called Mahjongg which should be placed in the
  451. default directory. Following is example contents of this file:
  452.  
  453.    ECHO OFF
  454.    CD\QUICKBBS\Mahjongg
  455.    Mahjongg Mahjongg.CFG
  456.    CD\QUICKBBS
  457.    QBBS.BAT
  458.  
  459. the last line in the Mahjongg file should invoke the batch file which loads
  460. the QuickBBS system.
  461.  
  462.               Mahjongg Pyramid  (C)opyright 1991  Page - 7
  463.  
  464. If this is a little unclear then please read your systems documentation for
  465. more detailed instructions.
  466.  
  467. If you use a door monitoring program then read their documentation for
  468. their specific setup.
  469.  
  470.  
  471.  
  472.                             Technical Support
  473.  
  474. If you have problems with the  Mahjongg Pyramid live game you may
  475. contact Mike Wilson at the Secret Service BBS 24 hours per day.
  476.  
  477. FIDO 1:262/29           PCRelay -> SECRET
  478.  
  479.  
  480.  
  481.  
  482.                               Order Information
  483.  
  484.  
  485. Just mail $20.00 Check or Money Order or Cash to:
  486.  
  487. Mike Wilson
  488. P.O. Box 9521
  489. Huntington, WV
  490.             25704
  491.  
  492. Make Checks out to Mike Wilson.
  493.  
  494.  
  495. Thank you for trying Mahjongg Pyramid and look for more games and utilities
  496. in the near future.
  497.  
  498. Special thanks to Jeff Sumberg for some great C routines used in this door!
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.               Mahjongg Pyramid  (C)opyright 1991  Page - 8